home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d6 / maintd30.arc / ARCA.DOC < prev    next >
Encoding:
Text File  |  1989-05-16  |  9.2 KB  |  234 lines
  1.  
  2. ARCA Command                                            Version 1.29
  3. ------------                                            Dec 9,  1987
  4.  
  5. Purpose:  To create or add files to an ARC archive file.
  6.  
  7. Format:   ARCA  [drive:][path]arcname.ext  [filespecs...]  [/d]  [/m]
  8.  
  9. Remarks:  The drive and path names are optional. If omitted, the
  10.         current drive and path name are used.
  11.  
  12.         The 'arcname' file name must be supplied.  The extension
  13.         defaults to ARC.  All files matching the supplied filespecs are
  14.         processed.  The input 'filespecs' may contain the * and ?
  15.         wildcard characters.
  16.  
  17.         If an existing archive file is used, the specified input
  18.         files are added to the end of it. There is no checking
  19.         for duplicate filenames and existing archive member files
  20.         are not replaced.  ARCA is best used when creating a brand-new
  21.         archive.
  22.  
  23.         The /D option specifies that all input files be deleted.  The
  24.         files are deleted after successful processing of all of the
  25.         input files.
  26.  
  27.         Invoking ARCA with no arguments yields a terse summary of
  28.         the needed parameters, along with a version header.
  29.  
  30.         ARCA uses only 2 compression techniques: a modified LZW
  31.         compression algorithm and repeated-string compression
  32.         ("packing").  The LZW algorithm is the same as the one used by
  33.         ARC, but modifications have been made to improve its compression
  34.         performance, especially when dealing with files containing
  35.         more "random" data such as executable files, though compression
  36.         performance for files containing less random data such as
  37.         textual files suffers a bit, but not much.  ARCA generally
  38.         performs better than ARC does -- it's significantly faster than
  39.         ARC while yielding smaller archives (hard to imagine getting
  40.         the best of two worlds!)
  41.  
  42.         Experiments have shown that the modified LZW compression algorithm
  43.         generally compresses binary files better than the Huffman algorithm
  44.         ("squeezing") can, Huffman compression is not used at all. If the
  45.         LZW compression fails to yield a smaller file, then packing is used
  46.         instead.  There are cases where a packed file is larger than the
  47.         original file, but these cases don't happen often enough for ARCA to
  48.         handle, for example, by copying the unchanged file to the archive.
  49.  
  50.         Though ARCA uses an improved LZW algorithm, its output is TOTALLY
  51.         compatible with the one used by System Enhancements Associates'
  52.         (21 New Street, Wayne NJ 07470) ARC program, which means that ARCs
  53.         created by ARCA can be processed by ARC, or by ARCE and ARCV
  54.         (companion extraction & table-of-contents lister programs also
  55.         written by Vernon Buerg and Wayne Chin).
  56.  
  57.  
  58.         ARCA 1.29, Copyright (c) 1986,1987, Wayne Chin and Vernon D. Buerg.
  59.         ALL RIGHTS RESERVED.
  60.  
  61.  
  62. ARCA Command                                            Version 1.29
  63. ------------                                            Dec 9,  1987
  64.  
  65.  
  66.                         Examples
  67.                         --------
  68.  
  69.         o  Create an archive file called TEST.ARC, and place all
  70.            files from the current directory into it:
  71.  
  72.               ARCA TEST *.*
  73.  
  74.         o  Create an archive called SOURCE.ARC in the subdirectory
  75.            \SAVE on drive B, and place all files with an extension
  76.            of ASM into to:
  77.  
  78.               ARCA B:\SAVE\SOURCE *.ASM
  79.  
  80.  
  81.         o  Add files to the archive on drive A called PROGA.ARC all
  82.            files in subdirectory \TEST on drive C, all files with a
  83.            filename beginning with NE, and all file from the subdirectory
  84.            \OLD on drive B:
  85.  
  86.               ARCA A:PROGA.ARC C:\TEST\*.* NE*.* B:\OLD\*.*
  87.  
  88.  
  89.  
  90. ARCA Command                                            Version 1.29
  91. ------------                                            Dec 9,  1987
  92.  
  93.                         Error Messages
  94.                         --------------
  95.  
  96.     ARCA: filename, analyzing, compressed.
  97.         This message is issued for each 'filename' added to
  98.         the archive file using LZW data compression. The program
  99.         continues.
  100.  
  101.     ARCA: filename, analyzing, packed.
  102.         This message is issued for each 'filename' added to
  103.         the archive file using repeated-string compression.  The
  104.         program continues.
  105.  
  106.     ARCA: No matching files!
  107.         No files were found that matched one of the 'filespecs'
  108.         in the command line. The program terminates.
  109.  
  110.     ARCA: You must use DOS version 2.0 or higher.
  111.         DOS version 2.0 or higher is required. The program terminates.
  112.  
  113.     ARCA: Insufficient memory.
  114.         A minimum of 34k is required. The program terminates.
  115.  
  116.     ARCA: Shrink failed.
  117.         This error should not occur. If it does, there is a problem
  118.         with DOS. The program terminates.
  119.  
  120.  
  121.     ARCA: Can't create archive file.
  122.         There is no room in the target directory to create the
  123.         specified archive file, or the target disk has become full.
  124.  
  125.     ARCA: Write error -- no more disk space? Don't trust this archive!
  126.         ARCA has encountered a problem writing to the target disk.  Check
  127.         if there's sufficient room on the target disk to contain the full
  128.         archive or delete unneeded files to free up some space.  ARCA
  129.         terminates leaving behind an archive that may not be usable --
  130.         check it carefully if you still want to use it (check the archive
  131.         by using ARCV or ARCE).
  132.  
  133.  
  134.  
  135. ARCA Command                                            Version 1.29
  136. ------------                                            Dec 9,  1987
  137.  
  138.                         Version history
  139.                         ---------------
  140.  
  141.         1.07 - 4/21/86, initial release
  142.         1.08 to 1.13,   internal versions
  143.         1.14 - 08/07/86
  144.                 add logic to sort input files using binary tree;
  145.                 modify filtering of ARC name when adding to ARC;
  146.                 modify processing of "/D" switch;
  147.                 do packing of file if LZW compression does no good;
  148.                 add optional code for 286 processor
  149.         1.15, August 08, 1986
  150.                 more 286-specific instructions
  151.         1.16, August 09, 1986
  152.                 more 286-specific instructions in compression code
  153.         1.17, August 10, 1986
  154.                 speed improvements in compression code
  155.         1.17a, August 10, 1986
  156.                 bug fix for the case of "arca x d:*.*", where d is not
  157.                 the current drive
  158.         1.18, August 11, 1986
  159.                 further speed tweaking in compression code; save a few
  160.                 more nanoseconds
  161.         1.19 to 1.21
  162.                 internal versions not released for general consumption
  163.         1.22, Sept 13, 1986
  164.                 improve error handling
  165.                 improve speed performance roughly 9%
  166.                 very modest compression perfomance improvement
  167.                 modify this document accordingly
  168.  
  169.         1.23, Feb 24, 1987
  170.                 add start-up banner
  171.                 omit "deleted" messages
  172.                 add 'copying' method
  173.  
  174.         1.27, May 30, 1987
  175.                 correct problem reverting to pack method (file size wrong)
  176.                 revert to copying if packing results in a larger file
  177.  
  178.         1.28, Oct 4, 1987
  179.                 correction for zero-byte files
  180.  
  181. |       1.29, Dec 9, 1987
  182. |               add /M option to add modified files only
  183. |               correction for zero-byte files, again
  184.  
  185.  
  186.  
  187. ARCA Command                                            Version 1.29
  188. ------------                                            Dec 9,  1987
  189.  
  190.  
  191.         As mentioned, ARCA is intended to be used to create a NEW archive,
  192.         not for appending or updating an existing archive, though ARCA does
  193.         not prevent you from doing so -- ARCA simply appends new files to the
  194.         named archive without deleting existing entries.  To properly append
  195.         or to update, you should use ARC instead.
  196.  
  197.         There may be two COM files. The ARCA286.COM file is for 80286 based
  198.         systems only.
  199.  
  200.  
  201.  
  202.                         License
  203.                         -------
  204.  
  205.         ARCA 1.29, Copyright (c) Wayne Chin and Vernon Buerg 1986,1987.
  206.         ALL RIGHTS RESERVED.
  207.  
  208.         ARCA is free, but it is a copyrighted work and may be distributed only
  209.         pursuant to this license.
  210.  
  211.         Permission is hereby granted to reproduce and disseminate ARCA so long
  212.         as:
  213.  
  214.            (1)  No remuneration of any kind is received in exchange; and
  215.  
  216.            (2)  Distribution is without ANY modification to the contents of
  217.                 ARCA.COM and all accompanying documentation and/or support
  218.                 files, including the copyright notice and this license.
  219.  
  220.         No copy of ARCA may be distributed without including a copy of this
  221.         license.
  222.  
  223.         Any other use is prohibited without express, written permission in
  224.         advance.
  225.  
  226.                 Vernon D. Buerg
  227.                 456 Lakeshire Drive
  228.                 Daly City, CA  94015
  229.                 CompuServe: 70007,1212
  230.                 Data/BBS:   415-994-2944
  231.  
  232.  
  233.  
  234.